home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir39 / csstools.zip / CSSTOOLS.TXT < prev    next >
Text File  |  1992-09-25  |  41KB  |  836 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                            CSS  DESKTOP     UTILITIES
  13.  
  14.                             SHAREWARE EVALUATION VERSION
  15.  
  16.                                   REFERENCE MANUAL
  17.                                      Version 1.0
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                                 Common Sense Software
  25.                                    P.O. Box 50941
  26.                              Indianapolis, Indiana 46250
  27.                                    (317) 594-0820
  28.  
  29.  
  30.  
  31.           This manual and the CSS Desktop Utilities are Copyright (C) 1992
  32.                    by Common Sense Software.  All rights reserved.
  33.  
  34.            Family Tree Print Utility, GENCHECK, and Common Sense Software
  35.                       are trademarks of Common Sense Software.
  36.  
  37.  
  38.                                                           GENCHECK - Page 2
  39.  
  40.  
  41.                                   TABLE OF CONTENTS
  42.  
  43.           COPYRIGHT...................................................2
  44.           LIMITATION OF LIABILITY.....................................2
  45.           SHAREWARE REGISTRATION INFORMATION..........................3
  46.           TRADEMARK ACKNOWLEDGMENT....................................4
  47.           SUPPORT.....................................................4
  48.           REQUIRED EQUIPMENT..........................................5
  49.           INTRODUCTION................................................5
  50.           INSTALLATION................................................5
  51.           BIFF.EXE - BINARY FILE DIFFERENCE UTILITY...................5
  52.           DIFF.EXE - ASCII FILE DIFFERENCE UTILITY....................7
  53.           FASTFORM.EXE - FAST DISK FORMATTER UTILITY..................10
  54.           GREN.EXE - GENERIC RENAME UTILITY...........................11
  55.           OPERATION - SEARCH.EXE......................................12
  56.           A LOOK AHEAD................................................14
  57.           REGISTRATION FORM - CSS DESKTOP UTILITIES VERSION 1.0.......16
  58.  
  59.                                       COPYRIGHT
  60.  
  61.           The CSS Desktop Utilities and manual are Copyright 1992 by Common
  62.           Sense Software.  Portions Copyright 1982-1990 Microsoft Corp.
  63.  
  64.                                LIMITATION OF LIABILITY
  65.  
  66.           THE CSS DESKTOP UTILITIES SOFTWARE ARE SUPPLIED AS IS.  COMMON
  67.           SENSE SOFTWARE MAKES NO WARRANTY OR REPRESENTATION, EITHER
  68.           EXPRESSED OR IMPLIED, WITH RESPECT TO THESE PROGRAMS, REFERENCE
  69.           MANUAL OR DOCUMENTATION INCLUDING THEIR QUALITY, PERFORMANCE,
  70.           MERCHANT ABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
  71.  
  72.           IN NO EVENT WILL COMMON SENSE SOFTWARE BE LIABLE FOR DIRECT,
  73.           INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
  74.           OUT OF THE USE OR INABILITY TO USE THESE PROGRAMS, REFERENCE
  75.           MANUAL OR DOCUMENTATION, EVEN IF COMMON SENSE SOFTWARE IS ADVISED
  76.           OF THE POSSIBILITY OF SUCH DAMAGES.  IN PARTICULAR, COMMON SENSE
  77.           SOFTWARE IS NOT RESPONSIBLE FOR ANY COSTS INCLUDING BUT NOT
  78.           LIMITED TO THOSE INCURRED AS A RESULT OF LOST PROFITS OR REVENUE,
  79.           LOSS OF USE OF COMPUTER PROGRAMS, LOSS OF DATA, THE COST OF
  80.           SUBSTITUTE PROGRAMS, CLAIMS BY THIRD PARTIES OR FOR OTHER SIMILAR
  81.           COSTS.  IN NO EVENT SHALL COMMON SENSE SOFTWARE'S LIABILITY FOR
  82.           ANY DAMAGES EVER EXCEED THE PRICE PAID FOR THE SOFTWARE LICENSE,
  83.           REGARDLESS OF THE FORM OF CLAIM.  THE PERSON USING THE SOFTWARE
  84.           BEARS ALL RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE.
  85.  
  86.           Some states do not allow the exclusion of the limit of liability
  87.           for consequential or incidental damages, so the above limitation
  88.           may not apply to you.
  89.  
  90.           This agreement shall be governed by the laws of the State of
  91.           Indiana and shall inure to the benefit of Common Sense Software
  92.           and any successors, administrators, heirs and assigns.  Any
  93.           action or proceeding brought by either party against the other
  94.           arising out of or related to this agreement shall be brought only
  95.  
  96.  
  97.                                                           GENCHECK - Page 3
  98.  
  99.  
  100.           in a STATE or FEDERAL COURT of competent jurisdiction located in
  101.           HAMILTON county, INDIANA.  The parties hereby consent to in
  102.           personam jurisdiction of said courts.
  103.  
  104.           Common Sense Software reserves the right to update the contents
  105.           of the CSS Desktop Utilities and their associated documentation
  106.           at its discretion and without the consent of or any obligation to
  107.           any licensed users.
  108.  
  109.                          SHAREWARE REGISTRATION INFORMATION
  110.  
  111.           Shareware distribution gives users a chance to try software
  112.           before buying it.  If you try a Shareware program and continue
  113.           using it, you are expected to register.  Individual programs
  114.           differ on details - some request registration while others
  115.           require it, some specify a maximum trial period.  With
  116.           registration, you get anything from the simple right to continue
  117.           using the software to an updated program with printed manual.
  118.  
  119.           Copyright laws apply to both Shareware and commercial software,
  120.           and the copyright holder retains all rights, with a few specific
  121.           exceptions as stated below.  Shareware authors are accomplished
  122.           programmers, like commercial authors, and programs are of
  123.           comparable quality.  (In both cases, there are good programs and
  124.           bad ones!) The main difference is in the method of distribution.
  125.           The author specifically grants the right to copy and distribute
  126.           the software, either to all and sundry or to a specific group.
  127.           For example, some authors require written permission before a
  128.           commercial disk vendor may copy their Shareware.
  129.  
  130.           Shareware is a distribution method, not a type of software.  You
  131.           should find software that suits your needs and pocketbook,
  132.           whether it's commercial or Shareware.  The Shareware system makes
  133.           fitting your needs easier, because you can try before you buy.
  134.           And because the overhead is low, prices are low also.  Shareware
  135.           has the ultimate money-back guarantee - if you don't use the
  136.           product, you don't pay for it.
  137.  
  138.           The CSS Desktop Utilities are Shareware programs and are provided
  139.           at no charge to the user for evaluation.  The essence of "user-
  140.           supported" software is to provide personal computer users with
  141.           quality software without high prices, and yet to provide
  142.           incentive for programmers to continue to develop new products.
  143.           If you find these programs useful and are continuing to use them
  144.           after a reasonable trial period, you must make a registration
  145.           payment of $10 to Common Sense Software.  The CSS Desktop
  146.           Utilities took many man-hours of software development effort to
  147.           produce, and registration fees are the ONLY WAY the authors
  148.           receive compensation for their time and effort.  Help to keep the
  149.           Shareware concept alive and well by becoming a registered user
  150.           after your evaluation period.  The CSS Desktop Utilities are not
  151.           copy protected or "crippled" in any way from the registered
  152.           user's version; Common Sense Software is counting on each user's
  153.  
  154.  
  155.                                                           GENCHECK - Page 4
  156.  
  157.  
  158.           honesty to register their copy.  EVERY REGISTRATION COUNTS,
  159.           INCLUDING YOURS!
  160.  
  161.           The cost of registration is $10.  As a registered user, you will
  162.           receive the latest registered user's version of the programs and
  163.           a registration number which will allow us to inform you of future
  164.           enhancements, and provide you with upgrades and new products at
  165.           reduced prices.  Registered users also receive technical support
  166.           by both mail and phone.  A registration form is provided at the
  167.           end of this documentation for your convenience.
  168.  
  169.           Common Sense Software is a member of the Association of Shareware
  170.           Professionals (ASP).  ASP wants to make sure that the shareware
  171.           principle works for you.  If you are unable to resolve a
  172.           shareware-related problem with an ASP member by contacting the
  173.           member directly, ASP may be able to help.  The ASP Ombudsman can
  174.           help you resolve a dispute or problem with an ASP member, but
  175.           does not provide technical support for members' products.  Please
  176.           write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442
  177.           or send a CompuServe message via CompuServe Mail to ASP Ombudsman
  178.           70007,3536.
  179.  
  180.                               TRADEMARK ACKNOWLEDGMENT
  181.  
  182.           Common Sense Software is a trademark of Common Sense Software.
  183.           Microsoft and MS-DOS are registered trademarks of Microsoft
  184.           Corporation.  IBM, XT, AT and PC-DOS are registered trademarks of
  185.           International Business Machines Corporation.
  186.  
  187.                                        SUPPORT
  188.  
  189.           Support will be provided to REGISTERED USERS by mail, CompuServe,
  190.           Prodigy, and telephone.  Telephone support will be available
  191.           weekday evenings from 6PM to 9PM Eastern Standard Time (EST) and
  192.           weekends from 10AM to 5PM EST.
  193.  
  194.                     CompuServe: E-Mail to: Keith R. Wehmeyer (70274,3020)
  195.  
  196.                     Prodigy:    E-Mail to Keith R. Wehmeyer (VMSR09A)
  197.  
  198.                     Address:    Common Sense Software
  199.                                 P.O. Box 50941
  200.                                 Indianapolis, Indiana  46250
  201.  
  202.                     Phone:      (317) 594-0820
  203.  
  204.           Please note that we are unable to assist you with directions
  205.           concerning the use of other programs with the CSS Desktop
  206.           Utilities.
  207.  
  208.  
  209.                                  REQUIRED EQUIPMENT
  210.  
  211.  
  212.                                                           GENCHECK - Page 5
  213.  
  214.  
  215.           The CSS Desktop Utilities will run on most IBM or compatible
  216.           computers with 256K of RAM, PC-DOS or MS-DOS 2.1 or greater and
  217.           two disk drives.
  218.  
  219.                                     INTRODUCTION
  220.  
  221.           The CSS Desktop Utilities were created to assist in the every-day
  222.           operation of the typical computer user.  The utilities consist of
  223.           five programs with the following capabilities:
  224.  
  225.           1.BIFF.EXE - A Binary file "Difference" program, which compares
  226.             two binary files and looks for differences.  This can be used
  227.             to compare two separate data files in order to note any
  228.             changes or differences.
  229.           2.DIFF.EXE - An ASCII file "Difference" program, which compares
  230.             two human-readable text files to find changes or differences.
  231.           3.FASTFORM.EXE - A fast formatting program which can be run from
  232.             a .BAT file, and formats 360K, 720K, 1.2M, and 1.44M diskettes
  233.             (both 5.25" and 3.5") with a variety of options.  Formatting
  234.             can be accomplished in as little as 28 seconds for a 360K
  235.             diskette, compared to 40 seconds for DOS's FORMAT.
  236.           4.GREN.EXE - A Generic Rename program, which can rename files
  237.             and sub directories, and automatically move renamed files to
  238.             new sub directories.
  239.           5.SEARCH.EXE - A file Search program, which scans one or
  240.             multiple files for a given phrase or word.
  241.  
  242.           This manual is divided into the following sections.  The first
  243.           part provides installation and set-up information so you can get
  244.           the CSS Desktop Utilities running on your computer.  A brief
  245.           description of how to operate each utility program then follows.
  246.  
  247.           While the CSS Desktop Utilities were designed to be operated by
  248.           the computer novice with little training, please take the time to
  249.           read this manual and get to know their capabilities.  It is best
  250.           to run each utility program as you read along, so that you can
  251.           understand exactly how it works.
  252.  
  253.           Enjoy the programs!  We hope the CSS Desktop Utilities are a
  254.           valuable assistant in you everyday computer operation.
  255.  
  256.                                     INSTALLATION
  257.  
  258.           Installation of the CSS Desktop Utility programs is easy, even
  259.           for the novice computer user.  Simply insert the Master diskette
  260.           into your diskette drive (A: or B:) then run the installation
  261.           program by typing "A:INSTALL" or "B:INSTALL" and pressing the
  262.           ENTER key.  Follow the directions which follow to install the
  263.           programs on either a floppy diskette or your hard drive.
  264.  
  265.                       BIFF.EXE - BINARY FILE DIFFERENCE UTILITY
  266.  
  267.           BIFF.EXE is the binary version of DIFF; it does differences on
  268.           any file type, byte by byte, in binary mode, displaying the
  269.  
  270.  
  271.                                                           GENCHECK - Page 6
  272.  
  273.  
  274.           differences in hexadecimal (Base 16) notation.  While similar to
  275.           the DIFF utility, it differs in a number of significant ways.  In
  276.           normal mode, BIFF will list the difference regions sequentially,
  277.           separated by a double bar, with the first file's contents on top.
  278.           Each line of output is preceded by the starting byte number.
  279.           Bytes are numbered in the file starting at 1.  Each byte in the
  280.           difference region will be shown in hexadecimal notation on the
  281.           left, and ASCII notation on the right, separated by a vertical
  282.           bar.  If a byte cannot be represented in ASCII on the screen
  283.           and/or printer, it will be shown as an asterisk ('*').  In
  284.           parallel mode, each difference region will contain all of the
  285.           bytes in the difference section, but no ASCII representation.
  286.           Both modes provide a closing summary, consisting of the number of
  287.           difference sections found, and the number of total bytes in those
  288.           sections.
  289.  
  290.           When invoking BIFF, you mush supply the name of at least two
  291.           files for BIFF to operate on.  If they are not supplied, or are
  292.           specified incorrectly, BIFF will prompt you for them.  Other
  293.           command line parameters you may wish to supply, but for which you
  294.           will not be prompted, include the following:
  295.  
  296.           PARALLEL - or any abbreviation thereof, in upper, mixed or lower
  297.           case. If selected, the differences between the files will be
  298.           presented to you in the parallel format discussed above, with a
  299.           file name header, and concurrent difference regions headed by the
  300.           starting file byte number.
  301.  
  302.           OUTPUT FILE - If a third file name is specified on the command
  303.           line, BIFF will write it's output to this file and not the
  304.           screen.  If the file already exists, it is over-written without
  305.           any warning.
  306.  
  307.           MATCH - the number of bytes that must match after a section of
  308.           differing data before BIFF decides that the files are
  309.           resynchronized.  The default is 30 bytes.  MATCH can be between 1
  310.           and 79.
  311.  
  312.           WIDTH - the number of characters per line BIFF will display. In
  313.           the parallel mode, the number of displayed bytes from each file
  314.           is roughly equal to (WIDTH / 6 - 1), while in normal mode it is
  315.           (WIDTH / 4 - 3).  The default value is 80 characters, with valid
  316.           values extending upward to 255 characters.
  317.  
  318.           BIFF will apply the integers you supply in the command line to
  319.           the proper parameters according to their value.  Input files must
  320.           be specified first and the output file specified last, and any
  321.           other parameters which are not numbers or 'parallel' will be
  322.           ignored.  MATCH and WIDTH parameters may be specified multiple
  323.           times, the last values read being the ones BIFF will use.  File
  324.           name and integer parameters may be intermixed.  An example:
  325.  
  326.           C> biff first.dat 40 second.dat 132 file.dif
  327.  
  328.  
  329.                                                           GENCHECK - Page 7
  330.  
  331.  
  332.           This command entry would cause BIFF to calculate the differences
  333.           between FIRST.DAT and SECOND.DAT using a match value of 40 bytes,
  334.           and place the 132 column wide output in the file FILE.DIF.
  335.           Another example:
  336.  
  337.           C> biff 140 file.xxx file.yyy lpt1 2 para
  338.  
  339.           This command entry would cause BIFF to print the differences
  340.           between FILE.XXX and FILE.YYY with 140 character wide output
  341.           being sent to the printer attached to the first parallel port of
  342.           the machine.  The differences would be calculated with a match
  343.           value of 2 bytes and displayed in the parallel format.
  344.  
  345.           BIFF produces output that contains characters only printable by
  346.           an IBM ProPrinter or compatible device.  IBM ProPrinter XLs can
  347.           be fed with 8-, 11-, or 14-inch paper, and print in pica (10
  348.           CPI), elite (12 CPI), or condensed (17.1 CPI) print modes.
  349.           Consult your ProPrinter User's Manual for instructions on loading
  350.           different sizes of paper and invoking the different print modes.
  351.           Use the chart below to determine the number of characters per
  352.           line for each setup:
  353.  
  354.                                 Paper width
  355.                                8"   11"   14"
  356.                             +-----+-----+-----+
  357.                          10 :  80 : 110 : 140 :
  358.                     C       +-----+-----+-----+
  359.                     P    12 :  96 : 132 : 168 :
  360.                     I       +-----+-----+-----+
  361.                          17 : 137 : 188 : 239 :
  362.                             +-----+-----+-----+
  363.  
  364.           While BIFF should work on just about any file you may have, it
  365.           does have some limitations:
  366.  
  367.           Maximum number of:
  368.             bytes per file               - 4,294,967,295 (4 MBytes - 1)
  369.             bytes per difference section -        65,534
  370.             difference sections          -        65,535
  371.  
  372.           BIFF gives no warning when these limits are reached, and may halt
  373.           DOS or other programs in memory if they are exceeded.
  374.  
  375.                       DIFF.EXE - ASCII FILE DIFFERENCE UTILITY
  376.  
  377.           DIFF.EXE is the equivalent of the VMS DIFF command, found on the
  378.           VAX line of computers by Digital Equipment Corporation.  However,
  379.           there are several differences.  Unlike the VMS command, DIFF will
  380.           not work predictably on binary files, nor will it recognize
  381.           differences in lines beyond the 255th character.  Many of the VAX
  382.           qualifiers are not supported in this version, but sufficient
  383.           interest in these features could prompt their integration.
  384.  
  385.  
  386.                                                           GENCHECK - Page 8
  387.  
  388.  
  389.           When invoking DIFF, you mush supply the name of at least two
  390.           files for DIFF to operate on.  Wild cards are supported in the
  391.           first file name only.  If wild cards are used, the second file
  392.           name must be a valid DOS path name.  If they are not supplied, or
  393.           are specified incorrectly, DIFF will prompt you for them.
  394.  
  395.           If a wild card name is specified, DIFF will search for files that
  396.           match the wild card spec. in the directory specified with that
  397.           name, or the default directory if none is specified.  It will
  398.           then search for each found file by name in the path specified in
  399.           the second file name.  If no match is found for that file, a
  400.           message is printed to that effect, and processing continues.
  401.  
  402.           Other command line parameters you may wish to supply, but for
  403.           which you will not be prompted, include the following:
  404.  
  405.           PARALLEL - or any abbreviation thereof, in upper, mixed or lower
  406.           case.  If selected, the differences between the files will be
  407.           presented to you in the  VMS /PARALLEL format with a file name
  408.           header, and concurrent difference regions headed by the starting
  409.           line number.  If not selected, the difference regions will be
  410.           listed sequentially, separated by a double bar, with the first
  411.           file's contents on top.  Both modes provide a closing summary.
  412.  
  413.           TABS - or any abbreviation thereof, in upper, mixed or lower
  414.           case.  If selected, this qualifier instructs DIFF to treat any
  415.           tabs found in each file as the appropriate number of blanks
  416.           during the compare operation.  Without this qualifier, DIFF will
  417.           identify lines as different when a tab has replaced one or more
  418.           blanks in the original (or vice-versa), even though the lines in
  419.           the output appear to be identical.  With this qualifier, DIFF
  420.           will evaluate the lines based on their perceived spacing.
  421.  
  422.           OUTPUT FILE - If a third file name is specified on the command
  423.           line, DIFF will write it's output to this file and not the
  424.           screen.  If the file already exists, it is over-written without
  425.           any warning.
  426.  
  427.           MATCH - the number of lines that must match after a section of
  428.           differing text before DIFF decides that the files are
  429.           resynchronized.  The default is 3 lines, the same as the VAX.
  430.           MATCH can be between 1 and 79 lines.
  431.  
  432.           WIDTH - the number of characters per line DIFF will display.  In
  433.           the parallel mode, the number of displayed characters from each
  434.           file is roughly equal to (WIDTH / 2 - 2).  The default value is
  435.           80 characters, with valid values extending upward to 255.
  436.  
  437.           GRAPHICAL - By default, DIFF uses ASCII characters to draw the
  438.           separator bars (or in parallel mode, boxes) in the output
  439.           listing.  If you would like DIFF to  use the extended ASCII set
  440.           line drawing characters to make these, specify GRAPHICAL, or any
  441.           abbreviation thereof, in upper, mixed or lower case.  These line
  442.           drawing characters make for better-looking output, but take a
  443.  
  444.  
  445.                                                           GENCHECK - Page 9
  446.  
  447.  
  448.           long time to print on a ProPrinter printer, and some printers
  449.           (e.g. Epson) won't handle them at all.  In general, you should
  450.           only use GRAPHICAL output for presentation purposes.
  451.  
  452.           DIFF will apply the integers you supply in the command line to
  453.           the proper parameters according to their value.  Input files must
  454.           be specified first and the output file specified last, and any
  455.           other parameters which are not numbers or 'parallel' or 'tabs'
  456.           will be ignored.  MATCH and WIDTH parameters may be specified
  457.           multiple times, the last values read being the ones DIFF will
  458.           use.  File name and integer parameters may be intermixed.  An
  459.           example:
  460.  
  461.           C> diff first.dat 4 second.dat 132 file.dif
  462.  
  463.           This command entry would cause DIFF to calculate the differences
  464.           between FIRST.DAT and SECOND.DAT using a match value of 4 lines,
  465.           and place the 132 column wide output in the file FILE.DIF.
  466.           Another example:
  467.  
  468.           C> diff 140 *.c source\ lpt1 2 para gra
  469.  
  470.           This command entry would cause DIFF to print the differences
  471.           between all the files matching the wild card specification *.C
  472.           and those files matching the same wild card name in the sub
  473.           directory SOURCE\.  The output will be 140 columns wide, and sent
  474.           to the printer attached to the first parallel port of the
  475.           machine.  The differences would be calculated with a match value
  476.           of 2 lines and displayed in the parallel format. The printer
  477.           attached must be able to handle the IBM extended character set
  478.           line drawing characters, as GRAPHICAL output boxes have been
  479.           specified.
  480.  
  481.           In GRAPHICAL mode, DIFF produces output that contains characters
  482.           only printable by an IBM ProPrinter or compatible device.  IBM
  483.           ProPrinter XLs can be fed with either 8-, 11-, or 14-inch paper,
  484.           and print in either pica (10 CPI), elite (12 CPI), or condensed
  485.           (17 CPI) print modes.  Consult your ProPrinter manual for
  486.           instructions on loading different sizes of paper and invoking the
  487.           different print modes.  Use the chart below to determine the
  488.           number of characters per line for each setup:
  489.  
  490.                                 Paper width
  491.                                8"   11"   14"
  492.                             +-----+-----+-----+
  493.                          10 :  80 : 110 : 140 :
  494.                     C       +-----+-----+-----+
  495.                     P    12 :  96 : 132 : 168 :
  496.                     I       +-----+-----+-----+
  497.                          17 : 137 : 188 : 239 :
  498.                             +-----+-----+-----+
  499.  
  500.           Only files written with CR or CR-LF record separators will work
  501.           correctly with DIFF.  EDLIN, QuickC, Programmer's Workbench and
  502.  
  503.  
  504.                                                          GENCHECK - Page 10
  505.  
  506.  
  507.           EDT+ all produce files of this type.  Files downloaded to the PC
  508.           with KERMIT or XMODEM are usually written in this manner. Files
  509.           created with Word, Write and Displaywrite must be exported to
  510.           ASCII before DIFF can be used effectively on them.
  511.  
  512.           Maximum number of:
  513.             files per run       -  unlimited
  514.             lines per file      -      32767
  515.             chars per line      -        256
  516.             difference sections -      32767
  517.             difference lines    -      32767
  518.  
  519.                      FASTFORM.EXE - FAST DISK FORMATTER UTILITY
  520.  
  521.           FASTFORM is a general purpose, high speed disk formatting program
  522.           which supports IBM PCs, XTs, and ATs and compatibles, as well as
  523.           both 5.25" and 3.5" diskette drives.  FASTFORM uses your
  524.           computer's BIOS (Basic Input / Output System) to control your
  525.           floppy drive, permitting it to work with nearly all types of disk
  526.           drive and controller card combinations.
  527.  
  528.           All FASTFORM parameters must be supplied on the command line
  529.           using the following syntax.  Parameters not meeting the syntax
  530.           will be ignored.
  531.  
  532.           C> fastform [DRIVE] [DENSITY] [/V] [/nnn]
  533.  
  534.           The parameter DRIVE specifies which drive is to be formatted.
  535.           The permissible values are A: or B:, as FASTFORM does not support
  536.           hard disk formatting.  If DRIVE is not specified, FASTFORM
  537.           assumes the A: drive.
  538.  
  539.           The DENSITY parameter specifies if the density of the format.
  540.           The permissible values are LOW or HIGH, which may be entered in
  541.           any combination of upper and lower case letters.  For a 5.25"
  542.           diskette drive, use LOW to format a 360K floppy, and HIGH to
  543.           format a 1.2M floppy.  For a 3.5" diskette drive, use LOW to
  544.           format a 720K floppy, and HIGH to format a 1.44M floppy.  If
  545.           DENSITY is not specified, FASTFORM determines the type of drive
  546.           in the computer and attempts to format the diskette for the
  547.           highest density possible in that drive.
  548.  
  549.           Diskettes may be optionally verified while they are being
  550.           formatted by adding the /V qualifier in either upper or lower
  551.           case.  Diskettes which are verified take longer to format, but
  552.           are guaranteed to have correct formatting information on each
  553.           track.  By default, no verification is performed, so that
  554.           diskettes may be formatted as quickly as possible
  555.  
  556.           The final FASTFORM parameter is used to specify the number of
  557.           sectors which will be allocated to diskette directory area.  Each
  558.           sector holds information on up to 16 files.  Both 360K and 720K
  559.           diskettes by default allocate 7 sectors, for a total of 42 files
  560.           permissible on a single diskette.  High density diskettes, such
  561.  
  562.  
  563.                                                          GENCHECK - Page 11
  564.  
  565.  
  566.           as 1.2M and 1.44M, allocate 14 sectors, for a total of 84 files
  567.           per diskette.  You may choose to reduce the number of sectors
  568.           allocated for directory space in order to maximize free space
  569.           (for BACKUP purposes, for example), or you may expand the amount
  570.           of directory space allocated in you want to put many small files
  571.           on a single diskette.  Maximum allocation values are as follows:
  572.  
  573.                           360K diskette  23 sectors
  574.                           720K diskette  85 sectors
  575.                           1.2M diskette 141 sectors
  576.                          1.44M diskette 169 sectors
  577.  
  578.           If no parameter is specified, FASTFORM uses the default values
  579.           normally used by DOS for the formatting process.  An example:
  580.  
  581.           C> fastform
  582.  
  583.           FASTFORM will format a diskette in the A: drive at the highest
  584.           possible density for that drive, with no verification, and with
  585.           the default number of sectors allocated for directory storage.
  586.  
  587.           C> fastform b: low /v /10
  588.  
  589.           FASTFORM will format a diskette in the B: drive at LOW density
  590.           (360K or 720K, depending upon the drive type) and verify while
  591.           formatting.  FASTFORM will then allocate 10 sectors for directory
  592.           space, permitting 160 files to be stored on this diskette.
  593.  
  594.           Another significant advantage of FASTFORM over the DOS FORMAT
  595.           command is its ability to be run from a Batch file.  FASTFORM
  596.           will wait to begin formatting until a diskette is inserted and
  597.           ready to format.  This includes testing to make sure that the
  598.           diskette is not write-protected.  If any problems occur during
  599.           the formatting process, an error message is displayed and a non-
  600.           zero number is returned to the Batch file using the DOS
  601.           ERRORLEVEL parameter.  See your DOS manual for additional
  602.           information on ERRORLEVEL and how you can use it in your DOS
  603.           Batch file application.
  604.  
  605.                           GREN.EXE - GENERIC RENAME UTILITY
  606.  
  607.           GREN is a general rename utility for the PC. Not only can it
  608.           rename files, but sub-directories as well, and can move files
  609.           from one sub directory to another.  Sub-directories cannot be
  610.           moved.
  611.  
  612.           GREN must be called with two arguments. The first is the current
  613.           name of the object, and the second is the new name. Only the
  614.           first two arguments are acted upon.
  615.  
  616.           Examples:
  617.  
  618.             C> GREN fred.dat george.dat
  619.  
  620.  
  621.                                                          GENCHECK - Page 12
  622.  
  623.  
  624.           This example will rename the file FRED.DAT in the current sub-
  625.           directory to GEORGE.DAT.
  626.  
  627.             C> GREN \data\new \data\old
  628.  
  629.           This example renames the sub-directory NEW to OLD. Note that the
  630.           directory is referenced from the top level directory. This allows
  631.           the renaming of sub-directories not in the current tree.
  632.  
  633.             C> GREN old\data old\buddy
  634.  
  635.           This example renames the sub-directory OLD to BUDDY, but it is
  636.           referenced from the current working directory.
  637.  
  638.             C> GREN \input\file.in \output\file.out
  639.  
  640.           This example renames the file FILE.IN to FILE.OUT, and moves it
  641.           to the OUTPUT sub-directory.
  642.  
  643.           Error Messages:
  644.  
  645.           'Usage: GREN from to' - Insufficient number of parameters
  646.           supplied.  Supply both the source and destination parameters.
  647.  
  648.           'No access permitted for xxxxxxxx.xxx' - The object was marked
  649.           read-only, it was locked by another user, an error occurred
  650.           during the rename or the disk was not present.
  651.  
  652.           'xxxxxxxx.xxx does not exist.' - The specified object could not
  653.           be found.
  654.  
  655.           'Cannot rename to a different device.' - An attempt was made to
  656.           move a file to a different logical disk.
  657.  
  658.  
  659.                                OPERATION - SEARCH.EXE
  660.  
  661.           SEARCH.EXE is the equivalent of the VMS SEARCH command found on
  662.           the VAX.  However, there are some differences.  Unlike the VMS
  663.           command, SEARCH will not work predictably on binary files, nor on
  664.           files with lines longer than 255 characters.  Also, you must have
  665.           ANSI.SYS loaded as a device from the CONFIG.DAT file at boot
  666.           time.  Many of the VAX qualifiers are not supported in this
  667.           version, but sufficient interest in these features could prompt
  668.           their integration.
  669.  
  670.           When invoking SEARCH, you must supply the name of the file for
  671.           SEARCH to operate on and the string to search for, in that order.
  672.           If they are not supplied, or are specified incorrectly, SEARCH
  673.           will prompt you for them.  Wild cards as used in DOS are
  674.           supported.  If you specify a wild card file name, all files
  675.           matching that wild card spec. in the current default directory
  676.           are searched.  If a file does not contain the string you are
  677.           searching for, its name is not displayed.
  678.  
  679.  
  680.                                                          GENCHECK - Page 13
  681.  
  682.  
  683.  
  684.           Search strings may be supplied with or without double quotes.  If
  685.           you specify a search string which contains blanks or special
  686.           characters, you MUST enclose it in double quotes.  If you wish to
  687.           specify a search string which contains a quote, either single or
  688.           double, do not supply it on the command line.  Search strings
  689.           entered at the prompt are read literally, without the need of
  690.           enclosing quotes, and single and double quotes may be specified
  691.           there.
  692.  
  693.           Other command line parameters you may wish to supply, but for
  694.           which you will not be prompted, include the following:
  695.  
  696.           OUTPUT= - To direct the output of the search function to a file
  697.           or device, precede its name with the characters OUTPUT= in upper,
  698.           mixed or lower case.  Do not include any blanks.  SEARCH will
  699.           write it's output to this file and not the screen.  If the file
  700.           already exists, it is over-written without any warning.  SEARCH
  701.           highlights each occurrence of your search string when the output
  702.           is going to the screen by using ANSI.SYS escape code sequences.
  703.           Since these sequences would garble the output if it were going to
  704.           a file and lock up (!) most printers, this is not done if the
  705.           output is redirected.
  706.  
  707.           WORD - or any abbreviation thereof, in upper, mixed or lower
  708.           case.  If selected, SEARCH will only display those occurrences of
  709.           the search string which are not immediately preceded or followed
  710.           by other letters, i.e. those strings which are entire words.
  711.  
  712.           NOEXACT - or any abbreviation thereof, in upper, mixed or lower
  713.           case.  If chosen, SEARCH will ignore the case of all letters in
  714.           matching the search string.
  715.  
  716.           BEFORE - the number of lines that SEARCH is to display that
  717.           precede the located search string.  If this number of lines is
  718.           not available when SEARCH encounters the string, it will display
  719.           what it has.
  720.  
  721.           AFTER - the number of lines that SEARCH is to display that follow
  722.           the located search string.  If this number of lines is not
  723.           available when SEARCH encounters the string, it will display what
  724.           it has.
  725.  
  726.           SEARCH will apply the first integer you supply in the command
  727.           line to the BEFORE parameter and the second (and all subsequent
  728.           ones) to the AFTER qualifier.  If you wish to have extra lines
  729.           displayed after the occurrence but not before, you must still
  730.           specify a value of zero(0) for BEFORE.
  731.  
  732.           Input file name must appear first, but other parameters may be
  733.           intermixed.
  734.  
  735.           An example:
  736.  
  737.  
  738.                                                          GENCHECK - Page 14
  739.  
  740.  
  741.           C> search *.c printf 3 output=lpt1 3 word
  742.  
  743.           This command entry would cause SEARCH to find and print all
  744.           occurrences of the string 'printf' (but not 'sprintf' and
  745.           'fprintf' because WORD was specified) in all the files which
  746.           match the wild card name '*.c' in the current directory on the
  747.           printer attached to the first parallel port of the machine.  Each
  748.           occurrence would be preceded and followed by the 3 surrounding
  749.           lines in the file.
  750.  
  751.           Another example:
  752.  
  753.           C> search *.h " _MAX_LINE " 0 4 output=match.max
  754.  
  755.           This command entry would cause SEARCH to find and print all
  756.           occurrences of the string ' _MAX_LINE ' (note the leading and
  757.           trailing blanks; ' _MAX_LINE_NUM' and 'OUT_MAX_LINE ' would NOT
  758.           be found) to the output file MATCH.MAX.  Each occurrence would be
  759.           listed with the four lines which follow it in the file.
  760.  
  761.           Only files written with CR or CR-LF record separators will work
  762.           correctly with SEARCH.  EDLIN, QuickC, EDT+ and PC-EDT all
  763.           produce files of this type.  Files downloaded to the PC with
  764.           KERMIT or XMODEM are usually written in this manner.  Files
  765.           created with MultiMate, DisplayWrite and ManuScript must be
  766.           exported to ASCII before SEARCH can be used effectively on them.
  767.  
  768.           Maximum number of...
  769.             files per search        -   unlimited
  770.             lines per file          -       32767
  771.             chars per line          -         255
  772.             lines before occurrence -         255 (approx.)
  773.             lines after occurrence  -   unlimited
  774.  
  775.                                     A LOOK AHEAD
  776.  
  777.           This version of the CSS Desktop Utilities would not have been
  778.           possible without the assistance of many registered users who
  779.           contributed their ideas for new this new product.  In order for
  780.           us to serve you better, please contact us with your ideas about
  781.           new features for our programs.  New feature suggestions are
  782.           always welcome; registered users may forward them to:
  783.  
  784.             Common Sense Software
  785.             P.O. Box 50941
  786.             Indianapolis, Indiana  46250
  787.  
  788.           Most importantly, we wish to thank our registered users for
  789.           continuing to support the Shareware concept by registering their
  790.           software and encouraging others to evaluate and register.  As
  791.           registrations are our only means of support for these programs,
  792.           we are indebted to you for your honesty.
  793.  
  794.  
  795.                                                          GENCHECK - Page 15
  796.  
  797.  
  798.                 REGISTRATION FORM - CSS DESKTOP UTILITIES VERSION 1.0
  799.  
  800.           Last Name _____________________________ First Name _____________
  801.  
  802.           Address ________________________________________________________
  803.  
  804.           City _______________________ State __________ Zip ______________
  805.  
  806.           Phone (______) ______ - ________
  807.  
  808.           Where did you hear about these programs? ________________________
  809.  
  810.           _________________________________________________________________
  811.  
  812.           Hardware Configuration:
  813.  
  814.           ____ PC or clone   ____ AT or clone   ____ 386/486   ____ PS/2
  815.  
  816.           ____ Monochrome    ____ CGA color     ____ EGA       ____ VGA
  817.  
  818.           ____ Floppy        ____ Hard Disk (if checked, size: ____ MB)
  819.  
  820.           ____ Mouse         ____ Modem   Printer type ___________________
  821.  
  822.           Floppy Disk Type:  ____ 5.25" ____ 3.5"
  823.  
  824.           VISA/MasterCard# __ __ __ __ __ __ __ __ __ __ __ __ __ __ __ __
  825.  
  826.           Expiration Date: ___ / ___  Authorized Signature: _______________
  827.  
  828.           Mail this form with your check for $10 (payable to Common Sense
  829.           Software) in U.S. DOLLARS ONLY, or VISA / MasterCard number to:
  830.  
  831.             CSS Desktop Utilities Registration
  832.             Common Sense Software
  833.             P.O. Box 50941
  834.             Indianapolis, Indiana 46250
  835.  
  836.           THANK YOU!!